Расширение поля формы для поля HTML-документа.ПриНажатии (Form extension for a HTML document field.OnClick)

Расширение поля формы для поля HTML-документа (Form extension for a HTML document field)

ПриНажатии (OnClick)

Доступен, начиная с версии 8.2.

Синтаксис:

ПриНажатии(<ДанныеСобытия>, <СтандартнаяОбработка>)

Параметры:

<ДанныеСобытия>

Тип: ФиксированнаяСтруктура.
Параметр заполняется фиксированной структурой со свойствами (всегда английского написания):

Anchor - Неопределено или элемент А, если нажали на ссылку;
Element - элемент, на который нажали;
Button - Неопределено или элемент input c типом button или элемент button, если нажали на кнопку;
Event - передается информация о событии, специфичная для используемого браузера;
Document - документ, являющийся владельцем элемента, на котором было произведено нажатие;
Href - Неопределено или значение поля Href элемента А. При этом, если в событии браузера используется ссылка с закодированными символами, не являющимися символами латинского алфавита, то в данном свойстве строка будет содержать раскодированные символы.

При использовании свойств и методов этих объектов, в связи с особенностями объектных моделей различных браузерах, их написание необходимо приводить в соответствии с требованиями конкретной модели.
Свойство Element всегда заполняется объектом, на который непосредственно нажали.
Свойства Anchor и Button, заполняются только тогда, когда нажатие произошло на ссылке или кнопке.
Например, ссылка, тег А может иметь вид <a href=”about:blank”> <b>bold anchor text</b> normal anchor text </a>.
После нажатия на normal anchor text, фиксированная структура заполнится следующим образом:

Данные.Anchor = ЭлементА;
Данные.Element = ЭлементА;
Данные.Button = Неопределено;
Данные.Document = ЭлементА.document/ЭлементА.ownerDocument;
Данные.Href = decodeURI(ЭлементА.Href).

А после нажатия на bold anchor text, то структура заполнится:

Данные.Anchor = ЭлементА;
Данные.Element = ЭлементB;
Данные.Button = Неопределено;
Данные.Document = ЭлементА.document/ЭлементА.ownerDocument;
Данные.Href = decodeURI(ЭлементА.Href).

В режимах запуска "Толстый клиент" и "Тонкий клиент" свойства Anchor, Element, Button, Event и Document содержат значения типа COMОбъект.
В режиме запуска "Веб-клиент" свойства Anchor, Element, Button, Event и Document содержат значения типа ВнешнийОбъект.

На мобильной платформе и в мобильном клиенте:

свойства Anchor, Element, Button, Event, всегда Неопределено;
Document содержит значения типа ВнешнийОбъект;
Href – содержит адрес перехода.

<СтандартнаяОбработка>

Тип: Булево.
В данный параметр передается признак выполнения стандартной (системной) обработки события. Если в теле процедуры-обработчика установить данному параметру значение Ложь, стандартная обработка события производиться не будет. Отказ от стандартной обработки не отменяет действие.
Значение по умолчанию: Истина.

Описание:

Возникает при нажатии (клике мышью или с помощью клавиатуры) на любом элементе внутри окна объекта ПолеHTMLДокумента.
Не поддерживается обработка событий поля HTML-документа для страниц, имеющих в адресе имя хоста веб-сервера, отличное от веб-клиента. Страницы, для которых требуется обработка событий, следует хранить в информационной базе.

Доступность:

Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, мобильное приложение (клиент).

Примечание:

На мобильной платформе возникает только при попытке перехода на другую страницу.

Использование в версии:

Доступен, начиная с версии 8.2.

Методическая информация